<template><div><h2 id="贡献导引" tabindex="-1"><a class="header-anchor" href="#贡献导引"><span>贡献导引</span></a></h2>
<p>Laravel 5.5 中文文档 /</p>
<p>本文档最新版为 <a href="https://learnku.com/docs/laravel/10.x" target="_blank" rel="noopener noreferrer">10.x</a>，旧版本可能放弃维护，推荐阅读最新版！</p>
<h2 id="laravel-源代码贡献指南" tabindex="-1"><a class="header-anchor" href="#laravel-源代码贡献指南"><span>Laravel 源代码贡献指南</span></a></h2>
<ul>
<li><a href="#bug-reports">错误反馈</a></li>
<li><a href="#core-development-discussion">核心开发讨论</a></li>
<li><a href="#which-branch">选择分支？</a></li>
<li><a href="#security-vulnerabilities">安全漏洞</a></li>
<li><a href="#coding-style">编码风格</a>
<ul>
<li><a href="#phpdoc">PHPDoc</a></li>
<li><a href="#styleci">StyleCI</a></li>
</ul>
</li>
</ul>
<h2 id="错误反馈" tabindex="-1"><a class="header-anchor" href="#错误反馈"><span>错误反馈</span></a></h2>
<p>为了鼓励积极协作，Laravel 强烈地鼓励使用 Pull Request 指出修改的内容，而不仅仅只是反馈错误。「错误反馈」也可以用 PR 来提交失败测试。</p>
<p>如果你要提交错误反馈，你的问题应该包含标题和明确的问题描述，并尽可能多的提供相关的信息和演示该问题的代码示例。错误反馈的目的是让你和其他人可以轻松地重现并修复错误。</p>
<p>请记住，错误反馈的初衷是让其它有相同问题的人能够和你协作解决问题。不要指望反馈错误后会很快有人修复它。创建错误反馈是能帮助你和其他人开始着手修复问题的途径。</p>
<p>Laravel 源代码托管在 GitHub 上面，并且每个 Laravel 的项目都有自己的代码仓库：</p>
<h2 id="核心开发讨论" tabindex="-1"><a class="header-anchor" href="#核心开发讨论"><span>核心开发讨论</span></a></h2>
<p>如果你想提出现有的 Laravel 的功能建议或者改进，请到 Laravel Internals 的 <a href="https://github.com/laravel/internals/issues" target="_blank" rel="noopener noreferrer">反馈栏</a> 讨论。如果你提出新功能，如果愿意，我们希望能请你至少实现一些完成该功能所需的代码。</p>
<p>有关错误、新功能和现有功能的实现的非正式讨论会在 <a href="http://larachat.co/" target="_blank" rel="noopener noreferrer">LaraChat</a> Slack 团队的 <code v-pre>#internals</code> 频道中进行。Laravel 的维护者 Taylor Otwell 通常都会在工作日的早上 8 点 到下午 5点（ UTC-06:00 或 America/Chicago ）出现在频道上，其它时间偶尔也会出现。</p>
<h2 id="选择分支" tabindex="-1"><a class="header-anchor" href="#选择分支"><span>选择分支？</span></a></h2>
<p><strong>所有</strong>错误修复都应该发送到最新的稳定分支或当前的 LTS 分支（5.5）上。错误修复<strong>不</strong>应该发送到 <code v-pre>master</code> 支，除非它们修复仅在即将发布的版本中存在的功能。</p>
<p>与当前 Laravel 版本<strong>完全向后兼容</strong>的<strong>次要</strong>功能可能会发送到最新的稳定分支。</p>
<p><strong>主要的</strong> 新功能都应该发送到 <code v-pre>master</code> 分支，它包含即将发布的 Laravel 版本。</p>
<p>如果不确定你的功能是主要的还是次要的，请咨询 <a href="http://larachat.co/" target="_blank" rel="noopener noreferrer">LaraChat</a> Slack 团队的 <code v-pre>#internals</code> 频道上的 Taylor Otwell。</p>
<h2 id="安全漏洞" tabindex="-1"><a class="header-anchor" href="#安全漏洞"><span>安全漏洞</span></a></h2>
<p>如果你发现 Laravel 存在安全漏洞，请发送电子邮件给Taylor Otwell： <a href="mailto:taylor@laravel.com" target="_blank" rel="noopener noreferrer">taylor@laravel.com。他会及时解决所有安全漏...</a></p>
<h2 id="编码风格" tabindex="-1"><a class="header-anchor" href="#编码风格"><span>编码风格</span></a></h2>
<p>Laravel 遵循 <a href="https://phphub.org/topics/2079" target="_blank" rel="noopener noreferrer">PSR-2</a> 编码规范和 <a href="https://phphub.org/topics/2081" target="_blank" rel="noopener noreferrer">PSR-4</a> 自动加载规范。</p>
<h3 id="phpdoc" tabindex="-1"><a class="header-anchor" href="#phpdoc"><span>PHPDoc</span></a></h3>
<p>以下是正确的 Laravel 注释的示例。请注意，<code v-pre>@param</code> 属性后跟两个空格、参数类型、两个空格，最后是变量名称：</p>
<div class="language-php line-numbers-mode" data-highlighter="prismjs" data-ext="php" data-title="php"><pre v-pre class="language-php"><code><span class="line"><span class="token doc-comment comment">/**</span>
<span class="line"> * 注册一个绑定到容器。</span>
<span class="line"> *</span>
<span class="line"> * <span class="token keyword">@param</span>  <span class="token class-name"><span class="token keyword">string</span><span class="token punctuation">|</span><span class="token keyword">array</span></span>  <span class="token parameter">$abstract</span></span>
<span class="line"> * <span class="token keyword">@param</span>  <span class="token class-name"><span class="token punctuation">\</span>Closure<span class="token punctuation">|</span><span class="token keyword">string</span><span class="token punctuation">|</span><span class="token keyword">null</span></span>  <span class="token parameter">$concrete</span></span>
<span class="line"> * <span class="token keyword">@param</span>  <span class="token class-name"><span class="token keyword">bool</span></span>  <span class="token parameter">$shared</span></span>
<span class="line"> * <span class="token keyword">@return</span> <span class="token class-name"><span class="token keyword">void</span></span></span>
<span class="line"> */</span></span>
<span class="line"><span class="token keyword">public</span> <span class="token keyword">function</span> <span class="token function-definition function">bind</span><span class="token punctuation">(</span><span class="token variable">$abstract</span><span class="token punctuation">,</span> <span class="token variable">$concrete</span> <span class="token operator">=</span> <span class="token constant">null</span><span class="token punctuation">,</span> <span class="token variable">$shared</span> <span class="token operator">=</span> <span class="token constant boolean">false</span><span class="token punctuation">)</span></span>
<span class="line"><span class="token punctuation">{</span></span>
<span class="line">    <span class="token comment">//</span></span>
<span class="line"><span class="token punctuation">}</span></span>
<span class="line"></span></code></pre>
<div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="styleci" tabindex="-1"><a class="header-anchor" href="#styleci"><span>StyleCI</span></a></h3>
<p>别担心你的编码风格不够漂亮！在合并 PR 后 <a href="https://styleci.io/" target="_blank" rel="noopener noreferrer">StyleCI</a> 会自动修正样式后再合并到 Laravel 仓库中。这样使得我们可以专注于贡献内容本身而不是编码风格。</p>
<h2 id="译者署名" tabindex="-1"><a class="header-anchor" href="#译者署名"><span>译者署名</span></a></h2>
<table>
<thead>
<tr>
<th>用户名</th>
<th>头像</th>
<th>职能</th>
<th>签名</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="https://github.com/medz" target="_blank" rel="noopener noreferrer">Seven Du</a></td>
<td><img src="https://avatars3.githubusercontent.com/u/5564821?s=300" alt="5564821?s=300"></td>
<td>翻译</td>
<td>基于 Laravel 的社交开源系统 <a href="https://github.com/slimkit/thinksns-plus" target="_blank" rel="noopener noreferrer">ThinkSNS+</a> 欢迎 Star。</td>
</tr>
<tr>
<td><a href="https://learnku.com/users/5350" target="_blank" rel="noopener noreferrer">@JokerLinly</a></td>
<td><img src="https://cdn.learnku.com/uploads/avatars/5350_1481857380.jpg" alt="5350_1481857380.jpg"></td>
<td>Review</td>
<td>Stay Hungry. Stay Foolish.</td>
</tr>
</tbody>
</table>
<hr>
<blockquote>
<p>{note} 欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。</p>
<p>转载请注明：本文档由 Laravel China 社区 <a href="https://laravel-china.org/" target="_blank" rel="noopener noreferrer">laravel-china.org</a> 组织翻译，详见 <a href="https://learnku.com/laravel/t/5756/laravel-55-document-translation-call-come-and-join-the-translation" target="_blank" rel="noopener noreferrer">翻译召集帖</a>。</p>
<p>文档永久地址： <a href="https://learnku.com/docs/laravel" target="_blank" rel="noopener noreferrer">《Laravel 中文文档》</a></p>
</blockquote>
</div></template>


